package com.admin_system.pojo;

import lombok.Getter;
import lombok.Setter;
import java.sql.Timestamp;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Size;
import jakarta.validation.constraints.Email;
import jakarta.validation.constraints.Pattern;

/**
 * 用户实体类
 * 表示系统用户信息，包括账户信息、个人资料和权限信息
 * 支持数据校验功能，确保数据符合业务规则
 */
@Setter
@Getter
public class User {
    /**
     * 用户唯一标识ID
     */
    private Integer id;
    
    /**
     * 用户名
     * 用于系统登录的唯一标识符
     * 必须非空且长度在2-20个字符之间
     */
    @NotBlank(message = "用户名不能为空")
    @Size(min = 2, max = 20, message = "用户名长度必须在2-20个字符之间")
    private String username;
    
    /**
     * 用户密码
     * 经过加密存储，不直接存储明文
     * 必须非空且长度在6-20个字符之间
     */
    @NotBlank(message = "密码不能为空")
    @Size(min = 6, max = 20, message = "密码长度必须在6-20个字符之间")
    private String password;
    
    /**
     * 用户邮箱地址
     * 用于系统通知和找回密码等功能
     * 必须非空且符合邮箱格式规范
     */
    @NotBlank(message = "邮箱不能为空")
    @Email(message = "邮箱格式不正确")
    private String email;
    
    /**
     * 用户手机号
     * 用于接收验证码和重要通知
     * 必须非空且符合中国大陆手机号格式
     */
    @NotBlank(message = "手机号不能为空")
    @Pattern(regexp = "^1[3-9]\\d{9}$", message = "手机号格式不正确")
    private String phone;
    
    /**
     * 用户真实姓名
     */
    private String fullName;
    
    /**
     * 用户性别
     */
    private String gender;
    
    /**
     * 账户创建时间
     */
    private Timestamp createTime;
    
    /**
     * 最后登录时间
     * 用于统计用户活跃度
     */
    private Timestamp lastLoginTime;
    
    /**
     * 账户是否激活
     * true表示账户可用，false表示账户被禁用
     */
    private Boolean isActive;
    
    /**
     * 用户角色
     * 用于权限控制，可能的值:
     * - ROLE_ADMIN: 管理员权限
     * - ROLE_USER: 普通用户权限
     */
    private String role;
    
    /**
     * 最后一次登录的JWT令牌
     * 用于实现单点登录和token失效控制
     */
    private String lastToken;
}